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Claim to Priority 

[0001] The present application claims the benefit of priority under 35 U.S.C. §1 19(e) to U.S. 
Provisional Patent Application entitled "IMPROVED CONNECTION POOL AND PREPARED 
STATEMENT CACHE", Application No. 60/450,976, filed on February 28, 2003, which 
application is incorporated herein by reference 

Copyright Notice 

[0002] A portion of the disclosure of this patent document contains material which is subject to 
copyright protection. The copyright owner has no objection to the facsimile reproduction by 
anyone of the patent document or the patent disclosure, as it appears in the Patent and Trademark 
Office patent file or records, but otherwise reserves all copyright rights whatsoever. 
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Cross Reference to Related Applications 
[0003] The present application is related to the following United States Patents and Patent 
Applications, which patents/applications are assigned to the owner of the present invention, and 
which patents/applications are incorporated by reference herein in their entirety: 
[0004] United States Patent Application No. 10/XXX,XXX, entitled "METHOD FOR 
IMPROVED CONNECTION POOL AND PREPARED STATEMENT CACHE", filed on xxx 
xx, 2003, Attorney Docket No. BEAS1340US3, currently pending. 

Field of the Invention 
[0005] The current invention relates generally to application server management, and more 
particularly to application server connection pool and statement cache management and 
implementation. 

Background of the Invention 
[0006] Application servers provide an environment for programmers to write application 
programs that perform services. Application servers typically include resources provided by 
third party vendors that can be called by application programs. Application servers may 
implement large numbers of the resource objects for application program use. One such 
application server is Web Logic Server (WLS) of BEA Systems of San Jose, California. 
[0007] Application servers implement a resource pool to manage and track resource status. 
Typically, different subsystems like JDBC, Connector and JMS subsystems use separate 
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resource pooling code implementations. Each implementation generally performs the same 
function for the corresponding system. 

[0008] Additionally, pool resource management and invocation can have negative effects on the 
efficiency of application program operation if the resources used by the application program are 
not properly managed in resource pools. One disadvantage of current application servers is that 
most of the management parameters are statically generated. What is needed is an application 
server that implements a resource pool that re-uses code common to different subsystems, allows 
for dynamic configuration, and achieves other improvements over previous application servers. 
Additionally, a statement cache that operates with the resource pool needed would be highly 
desirable. 
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Summary of the Invention 
[0009] In one embodiment of the present invention, an improved resource pool is provided that 
provides for dynamic configuration and is comprised of code that is configured to be used for 
different subsystems, including JDBC, Connector, and JMS subsystems. Pool maintenance, 
resource object creation and timeout, multiple deque management, and pool state transition 
features are provided. An application server may include at least one resource pool object, 
wherein each resource pool object represents a resource pool in the application server. An 
improved prepared statement cache is also provided that works in conjunction with the resource 
pool implementation to more effectively provide for prepared statement processing. 
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Brief Description of the Drawings 
[0010] FIGURE 1 is an illustration of a method for performing connection pool maintenance in 
accordance with one embodiment of the present invention. 

[0011] FIGURE 2 is an illustration of a method for performing pool size maintenance in 
accordance with one embodiment of the present invention. 

[0012] FIGURE 3 is an illustration of a method for performing resource maintenance in 
accordance with one embodiment of the present invention. 

[0013] FIGURE 4 is an illustration of a method for performing maintenance on connection pool 
deques in accordance with one embodiment of the present invention. 

[0014] FIGURE 5 is an illustration of a method for performing resource creation in accordance 
with one embodiment of the present invention. 

[0015] FIGURE 6 is an illustration of a method for performing maintenance on reserved 
resources in accordance with one embodiment of the present invention. 

[0016] FIGURE 7 is an illustration of system of state transitions for a resource pool in 
accordance with one embodiment of the present invention. 



Attorney Docket No.:BEA1340US2 5 

sbachmann/wp/beas/1340US2/bea 1340us2.001.patapln.doc Express Mail Mailing No. EV 327 622 815 US 



Detailed Description 

[0017] In one embodiment of the present invention, an improved resource pool is provided that 
provides for dynamic configuration and is comprised of code that is configured to be used for 
different subsystems, including JDBC, Connector, and JMS subsystems. Pool maintenance, 
resource object creation and timeout, multiple deque management, and pool state transition 
features are provided. An application server may include at least one resource pool object, 
wherein each resource pool object represents a resource pool in the application server. An 
improved prepared statement cache is also provided that works in conjunction with the resource 
pool implementation to more effectively provide for prepared statement processing. 
[0018] Previously, JDBC and Connector subsystems within typical application servers have their 
own connection pool implementations. In one embodiment of the present invention, the JDBC, 
Connector, and JMS subsystems share common resource pool functions. Other subsystems may 
use the common resource pool functions as well. These three and other subsystems reuse code 
that implements common resource pooling functionality. 

[0019] Resource pools may be implemented with a resource pool object. In one embodiment, 
resource pools consist of three deques called "RESERVED", "AVAILABLE", and 
"UNAVAILABLE". The deques may be implemented using proprietary (NOT 
java.util.LinkedList) doubly-linked lists. The three deques will respectively contain instances of 
resources that are currently reserved by, available or unavailable to be reserved by callers such as 
application programs. RESERVED contains resource instances that have been requested or are 
in use. AVAILABLE contains resource instances currently available in the resource pool. 
UNAVAILABLE will contain resource instances that were previously not created successfully 
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or able to be refreshed, typically because the backend system (e.g., Database) is currently 
unavailable. 

[0020] FIG. 1 illustrates a method 100 for performing connection pool maintenance in 
accordance with one embodiment of the present invention. In one embodiment, method 100 is 
performed every time a resource pool object task is executed for a resource pool. Method 100 
begins with start step 105. Next, any pool sizing maintenance is performed at step 110. 
Resource maintenance is then performed at step 120. Maintenance is then performed on 
Connection Pool deques at step 130. Operation of method 100 then terminates at step 135. For 
each of steps 110 through 130, the application server system may determine whether or not any 
action is actually performed. Thus, each of steps 110 through 130 is optional, and may be 
performed in a different order or not at all. In one embodiment, method 100 is carried out by a 
pool maintenance task that is created internally by the resource pool object and configured to run 
periodically. Steps 1 10, 120 and 130 are discussed in more detail in the methods illustrated in 
FIGs 2, 3 and 4, respectively. 

[0021] FIG. 2 illustrates a method 200 for performing pool size maintenance in accordance with 
one embodiment of the present invention. Method 200 begins with start step 205. Next, the 
resource pool object determines whether or not to perform a resource pool shrink check at step 
210. Thus, the resource pool object determines whether or not it should inquire if pool shrinking 
may be necessary. In one embodiment, the resource pool object may implement pool shrinking 
periodically. In this case, an attribute may be set that determines the frequency of pool 
shrinking. The shrinking frequency attribute may be set by an application program or by the 
resource pool object. In one embodiment, the attribute is called "ShrinkFrequencySeconds". If 

\ 
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the resource pool object is to check for required pool shrinking, operation continues to step 220. 
If a pool shrink check is not required, operation continues to step 245. 
[0022] The resource pool object determines if pool shrinking is necessary at step 220. In one 
embodiment, pool shrinking is necessary if any resources are contained within the AVAILABLE 
AND UNAVAILABLE deque. In one embodiment, pool shrinking may be necessary if the 
number of resources currently in the pool exceeds the number of total resources allowed in a 
pool, or if the number of unavailable resources in a pool exceeds the number of unavailable 
resources allowed in a pool. Both the maximum resources allowed and maximum unavailable 
resources allowed may be set using a resource pool parameter. If pool shrinking is to be 
performed, operation continues to step 230. If no pool shrinking is to be performed, operation 
continues to step 245. At step 230, resources in the UNAVAILABLE deque are reduced. In one 
embodiment, the number of resources in the UNAVAILABLE deque is reduced to the coincide 
with the value of a highest number of UNAVAILABLE resources parameter. In one 
embodiment, the resource pool object destroys resources in the UNAVAILABLE deque. Next, 
resources in the AVAILABLE deque are reduced. In one embodiment, the number of resources 
in the AVAILABLE deque is reduced such that the total resources in the pool coincides with the 
value of a maximum number of resources parameter. In one embodiment, the resource pool 
object destroys resources in the AVAILABLE deque. Operation of method 200 then terminates 
at step 245. 

[0023] FIG. 3 illustrates a method 300 for performing resource maintenance in accordance with 
one embodiment of the present invention. Method 300 begins with start step 305. Next, the 
resource pool object determines whether or not to test resources at step 310. In one embodiment, 
the resource pool object may test resources periodically. In this case, an attribute may be set that 
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determines the frequency of resource testing. The resource testing attribute may be set by an 
application program or by the resource pool object. In one embodiment, the attribute is called 
"TestFrequencySeconds". If the resource pool object is to perform test resources, operation 
continues to step 320. If a resource test is not required, operation continues to step 345. 
[0024] Resources are tested at step 320. In one embodiment, the resource test determines if the 
resource is functioning properly. If at step 330 any resources are determined to need refreshing, 
operation of method 300 continues to step 340. Resources may be determined to require 
refreshing based on the results of the resource test. If no resources need refreshing, operation 
continues to step 345. At step 340, resources are refreshed. Operation of method 300 then ends 
at step 345. 

[0025] FIG. 4 illustrates a method 400 for performing maintenance on connection pool deques in 
accordance with one embodiment of the present invention. Method 400 begins with start step 
405. The UNAVAILABLE and RESERVED deques are traversed by the resource pool object at 
step 410. In one embodiment, traversing the UNAVAILABLE and RESERVED deques includes 
determining what resources are in each deque, if any. Maintenance is then performed on the 
UNAVAILABLE deque at step 420. In one embodiment, the maintenance in step 420 includes 
scheduling resource creation for each resource in the UNAVAILABLE deque. Scheduled 
resource creation is discussed in more detail with reference to FIG. 5. Maintenance is then 
performed on the RESERVED deque at step 420. In one embodiment, the maintenance in step 
420 includes scheduling maintenance for each resource in the RESERVED deque. Scheduled 
RESERVED maintenance is discussed in more detail with reference to FIG. 6. Operation of 
method 400 then ends at step 435. 
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[0026] FIG. 5 illustrates a method 500 for performing resource creation in accordance with one 
embodiment of the present invention. Method 500 may be performed by a resource creation 
retry task. In one embodiment, a resource is added to the UNAVAILABLE deque by the 
resource pool object if the resource cannot be created or refreshed. The next time method 100 
executes and finds this resource on the UNAVAILABLE deque, the resource pool object will 
schedule the resource creation retry task on the resource. 

[0027] Operation of method 500 begins with start step 505. Next, the resource pool object 
attempts to create the resource at step 510. If the resource pool object determines at step 520 that 
the creation attempt was successful, operation continues to step 530. If the creation attempt is 
determined to have failed, operation continues to step 545. At step 530, the created resource is 
moved to the AVAILABLE deque. The resource pool object is thus made available to an 
application. Next, the resource creation retry task on the resource is cancelled at step 540. 
Operation of method 500 then ends at step 545. In one embodiment, the periodicity of the 
resource creation retry attempts can be configured by either an application or the resource pool 
object. In an embodiment, an attribute "ResourceCreationRetry Seconds" may be set to 
determine the periodicity of the of the resource creation retry attempts. 
[0028] FIG. 6 illustrates a method 600 for performing maintenance on reserved resources in 
accordance with one embodiment of the present invention. Method 600 may be performed by an 
inactive resource timeout task. In one embodiment, a resource is added to the RESERVED 
deque when it is called by an application program. The next time method 100 is performed, such 
as during execution of the pool maintenance task, and the resource is found on the RESERVED 
deque, the resource pool object may schedule an inactive resource timeout task on the resource. 
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[0029] Operation of method 600 begins with start step 605. At step 610, a check is made to 
determine whether a particular resource has been used since the last execution of method 600. In 
one embodiment, the check includes determining whether or not the resource has been used since 
the last execution of the inactive resource timeout task. If the resource was not used, operation 
continues to step 620. If the resource was used since the last timeout check, operation continues 
to step 635. At step 620, the resource is moved to the AVAILABLE deque. In this case, the 
resource is released back into the resource pool and made available to application programs. The 
inactive resource timeout task on the particular resource is then cancelled at step 630. Operation 
of method 600 then terminates at step 635. In one embodiment, the periodicity of the resource 
timeout check can be configured by either an application or the resource pool object. In an 
embodiment, an attribute "InactiveResourceTimeoutSeconds" may be set to determine the 
periodicity of the of the resource timeout checks. 

[0030] In embodiments discussed above, the methods of FIGs. 1 , 5 and 6 may be carried out by 
tasks. In this embodiment, the pool maintenance task associated with method 100 may create the 
resource creation retry task associated with method 500 and the inactive resource timeout task 
associated with method 600. A resource creation retry task may be created on a resource only 
after the resource is moved into the UNAVAILABLE deques. An inactive resource timeout task 
may be created on a resource only after the resource is moved into the RESERVED deques. The 
resource creation retry task and the inactive resource timeout task are each cancelled when the 
corresponding resource is moved off the UNAVAILABLE or RESERVED deques. In one 
embodiment, no individual task is scheduled on resources sitting on the AVAILABLE deque. 
Resource pools may be in one of several operational states. In one embodiment, the resource 
pool states may include "SHUTDOWN", "SUSPENDED" and "RUNNING". FIG. 7 illustrates 
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a system 700 of state transitions for a resource pool in accordance with one embodiment of the 
present invention. System 700 includes a null state 710, a shutdown state 720, a suspended state 
730, and a running state 740. State transitions are allowed as indicated by the directional arrows 
in system 700. In particular, when a resource pool (RP) object is created, the RP state transitions 
from null to SHUTDOWN. When a RP is started, the RP state transitions from SHUTDOWN to 
SUSPENDED. When a suspended RP is resumed, the RP state transitions from SUSPENDED to 
RUNNING. When a RP is suspend, the RP state transitions from RUNNING to SUSPENDED. 
When an RP is forcefully Suspended, the RP state transitions from RUNNING to SUSPENDED. 
When an RP is shutdown, the RP state transitions from SUSPENDED to SHUTDOWN. If a 
valid state transition is attempted multiple times, all but the first attempt are deemed non- 
operation. In one embodiment, a resource in a pool can only be reserved when the resource pool 
is in the RUNNING state. When the pool is in the SHUTDOWN state, release, shrink and reset 
operations can not be performed. 

[0031] In one embodiment, a resource pool may be implemented as a Java instance of a class. 
The class may extend the abstract class weblogic.common.resourcepool.ResourcePoolImpl in 
WLS (which implements the interface weblogic.common.resourcepool.ResourcePool). The 
interface weblogic.common.resourcepool.ResourcePool is shown below. The only method that 
will be declared abstract in this class will be "initPooledResourceFactoryO". Every other method 
in ResourcePool will be implemented in the base implementation ResourcePoolImpl (but can be 
overridden in the subclasses). In one embodiment of the JDBC subsystem, the WLS class 
weblogic.jdbc.common.internal.ConnectionPool extends the class ResourcePoolImpl. 

import java .util . Properties ; 

// pool of PooledResource objects 

public interface ResourcePool extends Obj ectLif eCycle { 
// pool management API 

Attorney Docket No.:BEA1340US2 12 

sbachmann/wp/beas/1340US2/beal 340us2.001.patapln.doc Express Mail Mailing No. EV 327 622 815 US 



I * * 

* initialize and return factory to create resource instances 

* ©param poollnfo Properties object containing pool configuration attributes 
(this object is initially passed to the generic resource pool object 
constructor when the subsystem is instantiating the pool) . 

*/ 

private PooledResourceFactory initPooledResourceFactory (Properties poollnfo) 

throws ResourceException; 
/** 

* shrink the pool 

* Shrinks the pool to the max of the currently reserved # resources or the 
initial size 

*/ 

public void shrink () throws ResourceException; 
I * ★ 

* refreshes all the resource instances in the pool. 
*/ 

public void refresh () throws ResourceException; 
I ★ * 

* ©return PoolState object containing the current state of the pool. Can be 
one of the following: 

* SHUTDOWN: initial (default) state 

* SUSPENDED: pool is disabled 

* RUNNING: pool is enabled 
*/ 

public PoolState getStateO; 

// return all the resources in the pool 

public PooledResourceWrapper [] getResources ( ) ; 

// pool access API 
/** 

* reserve a resource in the pool 

* ©param waitSeconds 

* 0 : wait for ever (blocking) 

* >0 : wait for specified # seconds (blocking with timeout) 

* -1 : don't wait (non-blocking) 

* ©param info if not null, selected resource must match this criterion 
*/ 

public PooledResource reserveResource (int waitSeconds, PooledResourcelnf o 
info) 

throws ResourceException; 
/*★ 

* reserve a resource in the pool, wait as long as specified in 

* "ReservedTimeoutSeconds" MBean attribute. 

* ©param info if not null, selected resource must match this criterion 
*/ 

public PooledResource reserveResource (PooledResourcelnf o info) 

throws ResourceException; 
/** 

* release the resource back to the pool 

* ©param resource to be released 
*/ 

public void releaseResource (PooledResource resource) 

throws ResourceException; 
I * * 

* create specified # instances of resources, upto the allowed 
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* maximum capacity of the pool, associate a PooledResourcelnf o object 

* from the array 'infoList' with each of the new resource instance. 
*/ 

public void createResources (int count, PooledResourcelnf o [] infoList) 

throws ResourceException; 
/** 

* select a resource from the pool that matches the specified 

* PooledResourcelnf o. returns •null* if none found. 

* @param info if not null, selected resource must match this criterion 
*/ 

public PooledResourceWrapper matchResource (PooledResourcelnf o info) 
throws ResourceException; 

// pool statistics API 

// returns leaked resources (reserved from the pool but not returned) 
public int getNumLeaked ( ) ; 

// increment # leaked resources (reserved from the pool but not returned) 
public int incrementNumLeaked ( ) ; 

// returns count of # failed attempts to refresh resources 
public int getNumFailuresToRef resh () ; 

// returns averaged time (in milliseconds) to create a resource instance, 
public int getCreationDelayTime ( ) ; 
// returns # waiters for resources 
public int getNumWaiters ( ) ; 

// returns high water mark of # waiters for resources 
public int getHighestNumWaiters ( ) ; 

// returns the longest # seconds a waiter waited for a resource 
public int getHighestWaitSeconds ( ) ; 

// returns total # resources allocated in the pool since its creation 

public int getTotalNumAl located () ; 

public int getTotalNumDestroyed ( ) ; 

public int getNumRe served ( ) ; 

public int getNumAvailable ( ) ; 

public int getNumUnavailable ( ) ; 

public int getHighestNumRe served ( ) ; 

public int getHighestNumUnavailable ( ) ; 

public int getHighestNumAvailable ( ) ; 

public int getAverageReserved ( ) ; 

public int getResourceLeakProf ileCount ( ) ; 

public ResourceLeakProf ile getResourceLeakProf iles ( index, count ) ; 

// dynamically tunable attributes 

public void setMaximumCapacity ( int) ; 

public void setlnitialCapacity ( int) / 

public void setCapacitylncrement (int ) ; 

public void setShrinkEnabled (boolean) ; 

public void setShrinkFrequencySeconds (int ) ; 

public void setlnactiveResourceTimeoutSeconds (int ) ; 

public void setResourceCreationRetrySeconds (int ) ; 

public void setHighestNumWaiters (int ) ; 

public void setHighestNumUnavailable (int ) ; 

public void setResourceReserveTimeoutSeconds (int) ; 

} 
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[0032] In one embodiment, resource pool objects may invoke the different methods of pooled 
resource objects during the lifetime of the pool. Some of these methods in accordance with this 
embodiment of the present invention are shown below. 



/* methods defined in weblogic . common. resourcepool . ObjectLif eCycle */ 
// create ' initialCapacity • instances of PooledResource 
start () 

call makeResources (initialCapacity) 

// enable pool and all resources within it 
resume () 

call PR. enable () on all PRs in the pool 

// disable pool and all resources within it. 
suspend () 

call PR. disable () on all PRs in the pool 

// disable pool and all resources within it. destroys and recreates resource 
instances currently reserved by users. 
forceSuspend () 

call PR. disable () on all PRs in the pool 

replaceResources (resvCount) 

// destroy all pooled resource instances in the pool 
shutdown ( ) 

calls PR. destroy () on all PRs in the pool 

/* methods defined in weblogic . common. resourcepool . ResourcePool */ 
// reserve a resource from the pool 
reserveResource ( ) 

if "testOnReserve" is enabled 

calls PR. test () to test resource 

if test fails, call PRF . ref reshResource ( ) 

// release a resource back into the pool 
releaseResource ( ) 

call PR. cleanup () 

if "testOnRelease" is enabled 

calls PR. test () to test resource 

if test fails, call PRF . ref reshResource ( ) 

// refresh all resources in the pool 
ref resh () 

call PRF. ref reshResource () for all PRs in the pool 

// shrink the pool to greater of current usage and initial capacity 
shrink () 

call PR. destroy () on all the PRs selected to destroy 

// private utility methods 
makeResources (count) 

do the following 'count' number of times 
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call PRF . createResource ( ) to create resource 
call PR. initialize () to initialize the created resource 
call PR.getCreationTime () to collect statistics 
if * testOnCreate' is enabled 
call PR.testO 

if test fails, call PRF . ref reshResource ( ) 
replaceResources (count) 

do the following 'count' number of times 
call PR. destroy () 
makeResources (count) 

[0033] As discussed above, a resource pool object may be configured with parameters that 
define and control the resource pool. These attributes- may be added to the respective external 
representations across the subsystems. Examples of these parameters are discussed briefly. The 
Capacitylncrement parameter specifies the increment by which the pool size is increased. In one 
embodiment, the maximum value is java.lang.Integer.MAX_VALUE, minimum is 1 and default 
is 1. 

[0034] The HighestNumWaiters parameter specifies the maximum number of waiters that can 
concurrently block waiting to reserve a resource from the pool. For example, the number of 
waiters may be the number of threads trying to access connection objects. In this case, the 
parameter specifies that there is a maximum number of threads that can wait for connection 
objects. The remainder of the threads will not by allowed to wait. Typically, they will perform 
re-try attempts. In one embodiment, the maximum value is java.lang.Integer.MAX_VALUE, 
minimum is 0 and default is 0 (feature disabled). 

[0035] The HighestNumUnavailable parameter specifies the maximum number of resource 
instances in the pool that can be made unavailable (to the application) for purposes like 
refreshing the resource. Note that in cases likes the backend system being unavailable, this 
specified value could be exceeded due to factors outside the pool's control. In one embodiment, 
the maximum value is java.lang.Integer.MAX_VALUE, minimum is 0 and default is 0 (feature 
disabled). The InitialCapacity specifies the number of resource instances contained in the pool 
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when it is first created. In one embodiment, the maximum value is 
java.lang.Integer.MAX_VALUE, minimum is 0 and default is 1. The 
InactiveResourceTimeoutSeconds parameter specifies the number of seconds of inactivity after 
which a reserved resource will automatically be reclaimed back by the pool. In one embodiment, 
the maximum value is java.lang.Integer.MAX_VALUE, minimum is 0 and default is 0 (feature 
disabled). The ShrinkEnabled parameter is a Boolean flag to enable the shrink feature. In one 
embodiment, the default is true. The MaximumCapacity parameter specifies the maximum 
number of resource instances contained in the pool. In one embodiment, the maximum value is 
java.lang.Integer.MAX_VALUE, minimum is 1 and default is 1. The Name parameter specifies 
the name of the pool. 

[0036] The ResourceCreationRetryFrequencySeconds parameter specifies the periodicity of 
retry attempts by the pool to establish resource instances. Unlike previous connection pools, if a 
requested resource, such as a database, is down, the resource pool will still be created. The 
created pool will attempt to retry connections with the down resource periodically as configured. 
In one embodiment, the maximum value is java.lang.Integer.MAX_VALUE, minimum is 0 and 
default is 0 (feature disabled). The ResourceReserveTimeoutSeconds parameter specifies the 
number of seconds after which the call to reserve a resource from the pool will timeout. Thus, 
this parameter allows a limit to be placed on the time waiting for a requested resource. In one 
embodiment, the maximum value is java.lang.Integer.MAX_VALUE, minimum is -1 and default 
is -1 (don't block when reserving resources). 

[0037] The ShrinkFrequencySeconds parameter specifies the periodicity at which the pool is 
shrunk. In one embodiment, the maximum value is java.lang.Integer.MAX_VALUE, minimum 
is 0 and default is 0 (attribute disabled to intemperate with deprecated attributes like 
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'ShrinkPeriodMinutes' for JDBC, etc.). The TestFrequencySeconds parameter specifies the 
periodicity at which resource instances in the pool are tested. In one embodiment, the maximum 
value is java.lang.Integer.MAX_VALUE, minimum is 0 and default is 0 (attribute disabled to 
interoperate with deprecated attributes like 'RefreshMinutes' for JDBC, etc.). The TestOnCreate 
parameter is a Boolean flag to enable testing of newly created resource instances. In one 
embodiment, the default is false. The TestOnRelease parameter is a Boolean flag to enable 
testing of resource instances when they are being released back into the pool. In one 
embodiment, the default is false. The TestOnReserve parameter is a Boolean flag to enable 
testing of resource instances when they are being reserved. In one embodiment, the default is 
false. 

[0038] A SecurityContext parameter may specify the minimum acceptable security context for a 
connection. This parameter specifies the security context that an application program is looking 
for in a resource. In one embodiment, the security context feature is an extension of the resource 
matching feature in WLS, which associates a context which each source. In the resource 
matching feature, and example of a resource context that a resource may require is 
javax.resource.spi.connetionrequestinfo. 

[0039] Some of the parameters discussed above may be dynamically configurable. In one 
embodiment, the dynamically configurable resources include MaximumCapacity, 
InitialCapacity, Capacitylncrement, ShrinkEnabled, TestOnReserve, TestOnRelease, 
TestOnCreate, ShrinkFrequency Seconds, InactiveResourceTimeoutSeconds, 

ResourceCreationRetrySeconds, HighestNum Waiters, HighestNumUnavailable, and 
ResourceReserveTimeoutSeconds. 
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[0040] Resource pools maintain a pool of pooled resource objects for use by application 
programs. In one embodiment, they implement the WLS interface 
weblogic.common.resourcepool. PooledResource. The WLS interface 

weblogic.common.resourcepool.PooledResource is illustrated below. In one embodiment in the 
JDBC subsystem, the class weblogic.jdbc.common.internal.ConnectionPoolEnv implements the 
interface PooledResource. The resource pooled object invokes the "createResource()" methods 
of PRF objects to create new resource instances and "refreshResource(PooledResource)" to 
refresh the specified resource. 



// objects that need to be pooled in ResourcePools must implement this 
interface . 

public interface PooledResource { 

// Lifecycle API 

/** 

* one time initialization of the object, typically used if creation 

* and initialization of the object are separate operations (hence 

* constructor can't do initialization also). 
*/ 

public void initialize () ; 

// enable object for use by consumers. 

public void enable {); 

// disable object so that it can't be used by consumers, 
public void disable (); 

// when a resource is being released back into the pool, this is called to 
clean the resource 

//before it is added back into the pool, 
public void cleanup () throws ResourceException; 

// destructor (typically, the inverse of the constructor and/or 

* initialize ' ) . 

public void destroy (); 

// Management API 
/** 

* test the resource 

* ©returns 

* 0: test wasn't run (presume success) 

* 1: test was successful 

* -1 : test failed 
*/ 

public int test() throws ResourceException; 

// returns time taken (in milliseconds) to create the resource 

public int getCreationTime ( ) throws ResourceException; 

// mark the resource as having being used. 

public void setUsedFlag (boolean newValue) ; 

// return whether the resource has been used or not. 
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public boolean getUsedFlag ( ) ; 
} 

[0041] A subsystem that wants to pool resources in a resource pooled object may provide a 
factory that creates the pooled resource object to be pooled. In one embodiment, the factory 
object will implement the WLS interface weblogic.common.resourcepool. 
PooledResourceFactory. The interface weblogic. common. resourcepool.PooledResourceFactory 
is shown below. In one embodiment of the JDBC subsystem, the class weblogic. 
jdbc.common.internal. ConnectionPoolEnvFactory implements the interface 
PooledResourceFactory. 

// Used to create instances of PooledResource objects, 
public interface PooledResourceFactory { 
I * * 

* Creates a new instance of a resource when invoked by a resource pool. 
* ©return New instance of the resource created 

*/ 

public PooledResource createResource ( ) throws ResourceException; 
/★ * 

* Refreshes specified instance of resource. 

* for resources that are wrappers around connections to backend systems, 
this method will typically close and re-establish the physical connection to 
the backend, while preserving the remaining state of the wrapper object. 

* for other resources, this method will typically call PR. destroy () on the 
existing resource and then call createResource () . 

*/ 

public void ref reshResource (PooledResource) throws ResourceException; 
} 

[0042] In one embodiment of the present invention, an improved prepared statement cache is 
provided. The prepared statement cache provides for generated prepared statements to be cached 
such that they can by used by other requesting entities without having to generate the prepared 
statement another time. The new implementation will enable applications to control and 
dynamically configure the number of prepared statements that are cached, select an algorithm 
from a predefined list that controls the behavior of the cache, dynamically enable, disable and 
clear the cache, and make use of the caching of prepared statements being done at the driver 
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level (when using JDBC 3.0 compliant drivers). The new functionality and control may be 
exposed via new methods on the JDBCConnectionPoolMBean and 
JDBCConnectionPoolRuntimeMBean. 

[0043] Several algorithms may be used to implement the prepared statement cache. In one 
algorithm, the prepared statements not used within a certain period may be removed from the 
cache. In another algorithm, once a certain number (that is less than the number of total prepared 
statements allowed) of prepared statements has been cached, for each added statement or number 
of statements added, the same number of statements is removed. The removed statements may 
be either the least used statements in a certain time period or for the duration of the cache. These 
algorithms are for illustration purposes, and other prepared statement caching algorithms are 
considered within the scope of the present invention. Alternatively, a non-algorithm caching 
method may be implemented wherein a set number of specific prepared statements are contained 
in the cache. The statement cache can also be cleared by an application program. Alternatively, 
selected prepared statements may be cleared from the cache. 

[0044] In one embodiment, the prepared statement cache may have a number of attributes to 
configure its operation. A StatementCacheSize attribute specifies the maximum size of the 
cache. Maximum allowed value for this attribute is 300, minimum is 0 and default is 0 (feature 
disabled). This attribute is dynamically configurable. A StatementCache Algorithm attribute 
specifies the algorithm to use to determine which statement in the cache should be closed and 
removed from the cache to make space for the new statement to be cached. A 
StatementCacheEnabled attribute indicates whether the application program requests to use the 
cache or not. Allowed values are "true" and "false" and default is "false" (feature disabled). This 
attribute is dynamically configurable. 
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[0045] Methods will be added to the JDBCConnectionPoolMBean to access or modify the above 
attributes: 

get StatementCacheSize () ; 

void setStatementCacheSize (int newVal); 

String getStatementCacheAlgorithm ( ) ; 

boolean getStatementCacheEnabled ( ) ; and 

void se tS tat ementCacheEnabled (boolean newVal) . 

[0046] A method added to the JDBCConnectionPoolRuntimeMBean to enable applications to 
clear the cache is: void clearStatementCache(). 

[0047] In one embodiment of the present invention, an improved resource pool is provided that 
provides for dynamic configuration and is comprised of code that is configured to be used for 
different subsystems, including JDBC, Connector, and JMS subsystems. Pool maintenance, 
resource object creation and timeout, multiple deque management, and pool state transition 
features are provided. An application server may include at least one resource pool object, 
wherein each resource pool object represents a resource pool in the application server. An 
improved prepared statement cache is also provided that works in conjunction with the resource 
pool implementation to more effectively provide for prepared statement processing. 
[0048] Other features, aspects and objects of the invention can be obtained from a review of the 
figures and the claims. It is to be understood that other embodiments of the invention can be 
developed and fall within the spirit and scope of the invention and claims. 
[0049] The foregoing description of preferred embodiments of the present invention has been 
provided for the purposes of illustration and description. It is not intended to be exhaustive or to 
limit the invention to the precise forms disclosed. Obviously, many modifications and variations 
will be apparent to the practitioner skilled in the art. The embodiments were chosen and 
described in order to best explain the principles of the invention and its practical application, 
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thereby enabling others skilled in the art to understand the invention for various embodiments 
and with various modifications that are suited to the particular use contemplated. It is intended 
that the scope of the invention be defined by the following claims and their equivalence. 
[0050] In addition to an embodiment consisting of specifically designed integrated circuits or 
other electronics, the present invention may be conveniently implemented using a conventional 
general purpose or a specialized digital computer or microprocessor programmed according to 
the teachings of the present disclosure, as will be apparent to those skilled in the computer art. 
[0051] Appropriate software coding can readily be prepared by skilled programmers based on 
the teachings of the present disclosure, as will be apparent to those skilled in the software art. 
The invention may also be implemented by the preparation of application specific integrated 
circuits or by interconnecting an appropriate network of conventional component circuits, as will 
be readily apparent to those skilled in the art. 

[0052] The present invention includes a computer program product which is a storage medium 
(media) having instructions stored thereon/in which can be used to program a computer to 
perform any of the processes of the present invention. The storage medium can include, but is 
not limited to, any type of disk including floppy disks, optical discs, DVD, CD-ROMs, 
microdrive, and magneto-optical disks, ROMs, RAMs, EPROMs, EEPROMs, DRAMs, 
VRAMs, flash memory devices, magnetic or optical cards, nanosystems (including molecular 
memory ICs), or any type of media or device suitable for storing instructions and/or data. 
[0053] Stored on any one of the computer readable medium (media), the present invention 
includes software for controlling both the hardware of the general purpose/specialized computer 
or microprocessor, and for enabling the computer or microprocessor to interact with a human 
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user or other mechanism utilizing the results of the present invention. Such software may 
include, but is not limited to, device drivers, operating systems, and user applications. 
[0054] Included in the programming (software) of the general/specialized computer or 
microprocessor are software modules for implementing the teachings of the present invention, 
including, but not limited to, configuring and implementing resource pool objects, pooled 
resource objects, and prepared statement caches. 
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